home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / utilit~1 / flut39st.zoo / fileutils-3.9 / man / ls.1 < prev    next >
Encoding:
Text File  |  1994-03-26  |  8.9 KB  |  257 lines
  1.  
  2.  
  3.  
  4. LS(1L)                               LS(1L)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        ls, dir,    vdir - list contents of    directories
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        l✓ls✓s  [-abcdfgiklmnpqrstuxABCFGLNQRSUX1] [-w cols]    [-T cols]
  12.        [-I pattern] [--all]  [--escape]     [--directory]    [--inode]
  13.        [--kilobytes]  [--numeric-uid-gid]  [--no-group]     [--hide-
  14.        control-chars] [--reverse] [--size] [--width=cols] [--tab-
  15.        size=cols]  [--almost-all] [--ignore-backups] [--classify]
  16.        [--file-type] [--full-time] [--ignore=pattern] [--derefer-
  17.        ence]     [--literal]     [--quote-name]        [--recursive]
  18.        [--sort={none,time,size,extension}]          [--for-
  19.        mat={long,verbose,commas,across,vertical,single-column}]
  20.        [--time={atime,access,use,ctime,status}]    [--help]  [--ver-
  21.        sion] [path...]
  22.  
  23. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  24.        This manual page    documents the GNU version of l✓ls✓s.  d✓di✓ir✓r and
  25.        v✓vd✓di✓ir✓r are    versions of l✓ls✓s with different default output for-
  26.        mats.   These  programs    list each given    file or    directory
  27.        path.  Directory    contents are sorted alphabetically.   For
  28.        l✓ls✓s,  files are by default listed    in columns, sorted verti-
  29.        cally, if the standard output  is  a  terminal;    otherwise
  30.        they  are  listed  one  per  line.   For    d✓di✓ir✓r, files are by
  31.        default listed in columns, sorted vertically.   For  v✓vd✓di✓ir✓r,
  32.        files are by default listed in long format.
  33.  
  34.    O✓OP✓PT✓TI✓IO✓ON✓NS✓S
  35.        _✓-_✓a_✓, _✓-_✓-_✓a_✓l_✓l
  36.           List  all    files in directories, including    all files
  37.           that start with `.'.
  38.  
  39.        _✓-_✓b_✓, _✓-_✓-_✓e_✓s_✓c_✓a_✓p_✓e
  40.           Quote nongraphic characters  in  file  names  using
  41.           alphabetic and octal backslash sequences like those
  42.           used in C.
  43.  
  44.        _✓-_✓c_✓, _✓-_✓-_✓t_✓i_✓m_✓e_✓=_✓c_✓t_✓i_✓m_✓e_✓, _✓-_✓-_✓t_✓i_✓m_✓e_✓=_✓s_✓t_✓a_✓t_✓u_✓s
  45.           Sort directory contents  according  to  the  files'
  46.           status  change  time  instead  of     the modification
  47.           time.  If    the long listing format     is  being  used,
  48.           print the    status change time instead of the modifi-
  49.           cation time.
  50.  
  51.        _✓-_✓d_✓, _✓-_✓-_✓d_✓i_✓r_✓e_✓c_✓t_✓o_✓r_✓y
  52.           List directories    like  other  files,  rather  than
  53.           listing their contents.
  54.  
  55.        _✓-_✓f     Do  not sort directory contents; list them in what-
  56.           ever order they are stored on the    disk.    The  same
  57.           as enabling _✓-_✓a and _✓-_✓U and    disabling _✓-_✓l_✓, _✓-_✓s_✓, and _✓-_✓t_✓.
  58.  
  59.        _✓-_✓-_✓f_✓u_✓l_✓l_✓-_✓t_✓i_✓m_✓e
  60.           List times in full, rather than using the     standard
  61.  
  62.  
  63.  
  64. FSF            GNU File Utilities            1
  65.  
  66.  
  67.  
  68. LS(1L)                               LS(1L)
  69.  
  70.  
  71.           abbreviation heuristics.
  72.  
  73.        _✓-_✓g     Ignored; for Unix    compatibility.
  74.  
  75.        _✓-_✓i_✓, _✓-_✓-_✓i_✓n_✓o_✓d_✓e
  76.           Print  the index number of each file to the left of
  77.           the file name.
  78.  
  79.        _✓-_✓k_✓, _✓-_✓-_✓k_✓i_✓l_✓o_✓b_✓y_✓t_✓e_✓s
  80.           If file sizes are    being listed, print them in kilo-
  81.           bytes.   This  overrides    the  environment variable
  82.           POSIXLY_CORRECT.
  83.  
  84.        _✓-_✓l_✓, _✓-_✓-_✓f_✓o_✓r_✓m_✓a_✓t_✓=_✓l_✓o_✓n_✓g_✓, _✓-_✓-_✓f_✓o_✓r_✓m_✓a_✓t_✓=_✓v_✓e_✓r_✓b_✓o_✓s_✓e
  85.           In addition to the name of  each    file,  print  the
  86.           file type, permissions, number of    hard links, owner
  87.           name, group name,    size in    bytes, and timestamp (the
  88.           modification time    unless other times are selected).
  89.           For files    with a time that is more  than    6  months
  90.           old or more than 1 hour into the future, the times-
  91.           tamp contains the    year instead of    the time of  day.
  92.  
  93.        _✓-_✓m_✓, _✓-_✓-_✓f_✓o_✓r_✓m_✓a_✓t_✓=_✓c_✓o_✓m_✓m_✓a_✓s
  94.           List  files  horizontally, with as many as will fit
  95.           on each line, separated by commas.
  96.  
  97.        _✓-_✓n_✓, _✓-_✓-_✓n_✓u_✓m_✓e_✓r_✓i_✓c_✓-_✓u_✓i_✓d_✓-_✓g_✓i_✓d
  98.           List the numeric UID and GID instead of the  names.
  99.  
  100.        _✓-_✓p     Append a character to each file name indicating the
  101.           file type.
  102.  
  103.        _✓-_✓q_✓, _✓-_✓-_✓h_✓i_✓d_✓e_✓-_✓c_✓o_✓n_✓t_✓r_✓o_✓l_✓-_✓c_✓h_✓a_✓r_✓s
  104.           Print question marks instead of nongraphic  charac-
  105.           ters in file names.
  106.  
  107.        _✓-_✓r_✓, _✓-_✓-_✓r_✓e_✓v_✓e_✓r_✓s_✓e
  108.           Sort directory contents in reverse order.
  109.  
  110.        _✓-_✓s_✓, _✓-_✓-_✓s_✓i_✓z_✓e
  111.           Print  the  size    of  each file in 1K blocks to the
  112.           left of the file name.  If the environment variable
  113.           POSIXLY_CORRECT  is  set,     512-byte blocks are used
  114.           instead.
  115.  
  116.        _✓-_✓t_✓, _✓-_✓-_✓s_✓o_✓r_✓t_✓=_✓t_✓i_✓m_✓e
  117.           Sort directory contents  by  timestamp  instead  of
  118.           alphabetically, with the newest files listed first.
  119.  
  120.        _✓-_✓u_✓, _✓-_✓-_✓t_✓i_✓m_✓e_✓=_✓a_✓t_✓i_✓m_✓e_✓, _✓-_✓-_✓t_✓i_✓m_✓e_✓=_✓a_✓c_✓c_✓e_✓s_✓s_✓,    _✓-_✓-_✓t_✓i_✓m_✓e_✓=_✓u_✓s_✓e
  121.           Sort directory contents  according  to  the  files'
  122.           last  access time    instead    of the modification time.
  123.           If the long listing format is being used,    print the
  124.           last  access time    instead    of the modification time.
  125.  
  126.  
  127.  
  128. FSF            GNU File Utilities            2
  129.  
  130.  
  131.  
  132. LS(1L)                               LS(1L)
  133.  
  134.  
  135.        _✓-_✓x_✓, _✓-_✓-_✓f_✓o_✓r_✓m_✓a_✓t_✓=_✓a_✓c_✓r_✓o_✓s_✓s_✓, _✓-_✓-_✓f_✓o_✓r_✓m_✓a_✓t_✓=_✓h_✓o_✓r_✓i_✓z_✓o_✓n_✓t_✓a_✓l
  136.           List the files in    columns, sorted    horizontally.
  137.  
  138.        _✓-_✓A_✓, _✓-_✓-_✓a_✓l_✓m_✓o_✓s_✓t_✓-_✓a_✓l_✓l
  139.           List all files in    directories, except for     `.'  and
  140.           `..'.
  141.  
  142.        _✓-_✓B_✓, _✓-_✓-_✓i_✓g_✓n_✓o_✓r_✓e_✓-_✓b_✓a_✓c_✓k_✓u_✓p_✓s
  143.           Do  not  list  files that    end with `~', unless they
  144.           are given    on the command line.
  145.  
  146.        _✓-_✓C_✓, _✓-_✓-_✓f_✓o_✓r_✓m_✓a_✓t_✓=_✓v_✓e_✓r_✓t_✓i_✓c_✓a_✓l
  147.           List files in columns, sorted vertically.
  148.  
  149.        _✓-_✓F_✓, _✓-_✓-_✓c_✓l_✓a_✓s_✓s_✓i_✓f_✓y
  150.           Append a character to each file name indicating the
  151.           file  type.  For regular files that are executable,
  152.           append a `*'.  The file type indicators are `/' for
  153.           directories, `@' for symbolic links, `|' for FIFOs,
  154.           `=' for sockets, and nothing for regular files.
  155.  
  156.        _✓-_✓G_✓, _✓-_✓-_✓n_✓o_✓-_✓g_✓r_✓o_✓u_✓p
  157.           Inhibit display of group information in a    long for-
  158.           mat directory listing.
  159.  
  160.        _✓-_✓L_✓, _✓-_✓-_✓d_✓e_✓r_✓e_✓f_✓e_✓r_✓e_✓n_✓c_✓e
  161.           List  the    files linked to    by symbolic links instead
  162.           of listing the contents of the links.
  163.  
  164.        _✓-_✓N_✓, _✓-_✓-_✓l_✓i_✓t_✓e_✓r_✓a_✓l
  165.           Do not quote file    names.
  166.  
  167.        _✓-_✓Q_✓, _✓-_✓-_✓q_✓u_✓o_✓t_✓e_✓-_✓n_✓a_✓m_✓e
  168.           Enclose file names in double quotes and quote  non-
  169.           graphic characters as in C.
  170.  
  171.        _✓-_✓R_✓, _✓-_✓-_✓r_✓e_✓c_✓u_✓r_✓s_✓i_✓v_✓e
  172.           List the contents    of all directories recursively.
  173.  
  174.        _✓-_✓S_✓, _✓-_✓-_✓s_✓o_✓r_✓t_✓=_✓s_✓i_✓z_✓e
  175.           Sort  directory  contents     by  file size instead of
  176.           alphabetically,  with  the  largest  files   listed
  177.           first.
  178.  
  179.        _✓-_✓U_✓, _✓-_✓-_✓s_✓o_✓r_✓t_✓=_✓n_✓o_✓n_✓e
  180.           Do  not sort directory contents; list them in what-
  181.           ever order they  are  stored  on    the  disk.   This
  182.           option  is  not  called  _✓-_✓f  because the Unix l✓ls✓s _✓-_✓f
  183.           option also enables _✓-_✓a and disables _✓-_✓l, _✓-_✓s, and _✓-_✓t.
  184.           It  seems    useless    and ugly to group those    unrelated
  185.           things together in one option.  Since  this  option
  186.           doesn't do that, it has a    different name.
  187.  
  188.  
  189.  
  190.  
  191.  
  192. FSF            GNU File Utilities            3
  193.  
  194.  
  195.  
  196. LS(1L)                               LS(1L)
  197.  
  198.  
  199.        _✓-_✓X_✓, _✓-_✓-_✓s_✓o_✓r_✓t_✓=_✓e_✓x_✓t_✓e_✓n_✓s_✓i_✓o_✓n
  200.           Sort  directory  contents     alphabetically     by  file
  201.           extension    (characters after the  last  `.');  files
  202.           with no extension    are sorted first.
  203.  
  204.        _✓-_✓1_✓, _✓-_✓-_✓f_✓o_✓r_✓m_✓a_✓t_✓=_✓s_✓i_✓n_✓g_✓l_✓e_✓-_✓c_✓o_✓l_✓u_✓m_✓n
  205.           List one file per    line.
  206.  
  207.        _✓-_✓w_✓, _✓-_✓-_✓w_✓i_✓d_✓t_✓h _✓c_✓o_✓l_✓s
  208.           Assume  the  screen  is  _✓c_✓o_✓l_✓s  columns  wide.   The
  209.           default is taken from the    terminal driver    if possi-
  210.           ble;  otherwise the environment variable C✓CO✓OL✓LU✓UM✓MN✓NS✓S is
  211.           used if it is set; otherwise the default is 80.
  212.  
  213.        _✓-_✓T_✓, _✓-_✓-_✓t_✓a_✓b_✓s_✓i_✓z_✓e _✓c_✓o_✓l_✓s
  214.           Assume that each tabstop is _✓c_✓o_✓l_✓s columns wide.  The
  215.           default is 8.
  216.  
  217.        _✓-_✓I_✓, _✓-_✓-_✓i_✓g_✓n_✓o_✓r_✓e _✓p_✓a_✓t_✓t_✓e_✓r_✓n
  218.           Do  not list files whose names match the shell pat-
  219.           tern _✓p_✓a_✓t_✓t_✓e_✓r_✓n unless they are given on  the  command
  220.           line.   As  in the shell,    an initial `.' in a file-
  221.           name does    not match a wildcard at    the start of _✓p_✓a_✓t_✓-
  222.           _✓t_✓e_✓r_✓n_✓.
  223.  
  224.        _✓-_✓-_✓h_✓e_✓l_✓p Print  a    usage message on standard output and exit
  225.           successfully.
  226.  
  227.        _✓-_✓-_✓v_✓e_✓r_✓s_✓i_✓o_✓n
  228.           Print version information    on standard  output  then
  229.           exit successfully.
  230.  
  231. B✓BU✓UG✓GS✓S
  232.        On  BSD systems,    the _✓-_✓s option reports sizes that are half
  233.        the correct values for files that are NFS-mounted from HP-
  234.        UX  systems.   On HP-UX systems,    it reports sizes that are
  235.        twice the correct values    for files  that     are  NFS-mounted
  236.        from BSD    systems.  This is due to a flaw    in HP-UX; it also
  237.        affects the HP-UX l✓ls✓s program.
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256. FSF            GNU File Utilities            4
  257.